package com.caregiver.watch.business.data.dao;

import com.baomidou.dynamic.datasource.annotation.DS;
import com.caregiver.watch.business.data.model.po.HealthBloodOxygen;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.Date;
import java.util.List;

import static com.caregiver.watch.common.constant.DataSourceName.SHARDING;

/**
 * 血氧数据访问接口
 * 提供对 health_blood_oxygen 表的基本操作
 */
@Mapper
@DS(SHARDING)
public interface HealthBloodOxygenDao {
    
    /**
     * 插入血氧数据
     * 
     * @param healthBloodOxygen 血氧数据实体
     * @return 影响的行数
     */
    int insert(HealthBloodOxygen healthBloodOxygen);
    
    /**
     * 批量插入血氧数据
     * 
     * @param healthBloodOxygenList 血氧数据实体列表
     * @return 影响的行数
     */
    int batchInsert(List<HealthBloodOxygen> healthBloodOxygenList);
    
    /**
     * 根据主键查询血氧数据
     * 
     * @param id 主键ID
     * @return 血氧数据实体
     */
    HealthBloodOxygen findById(Long id);
    
    /**
     * 根据用户ID和时间范围查询血氧数据
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 血氧数据列表
     */
    List<HealthBloodOxygen> findByUserIdAndTimeRange(@Param("userId") Long userId, 
                                                     @Param("startTime") Date startTime, 
                                                     @Param("endTime") Date endTime);
    
    /**
     * 根据用户ID、时间范围和最小血氧值查询血氧数据
     * 
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param minOxygenThreshold 最小血氧阈值
     * @return 血氧数据列表
     */
    List<HealthBloodOxygen> findByUserIdAndTimeRangeAndMinOxygen(@Param("userId") Long userId, 
                                                                @Param("startTime") Date startTime, 
                                                                @Param("endTime") Date endTime,
                                                                @Param("minOxygenThreshold") BigDecimal minOxygenThreshold);
    
    /**
     * 根据主键更新血氧数据
     * 
     * @param healthBloodOxygen 血氧数据实体
     * @return 影响的行数
     */
    int updateById(HealthBloodOxygen healthBloodOxygen);
    
    /**
     * 根据主键删除血氧数据
     * 
     * @param id 主键ID
     * @return 影响的行数
     */
    int deleteById(Long id);

    /**
     * 查询用户最新的血氧数据
     *
     * @param userId 用户ID
     * @param deviceUuid 设备UUID
     * @return 血氧数据实体
     */
    HealthBloodOxygen queryLatestBpData(@Param("userId") Long userId,
                                        @Param("deviceUuid") String deviceUuid);

    /**
     * 查询用户指定时间范围内的血氧数据
     *
     * @param userId 用户ID
     * @param deviceUuid 设备UUID
     * @param start 开始时间
     * @param end 结束时间
     * @return 血氧数据列表
     */
    List<HealthBloodOxygen> queryBloodOxygenData(@Param("userId") Long userId,
                                                 @Param("deviceUuid") String deviceUuid,
                                                 @Param("start") LocalDateTime start,
                                                 @Param("end") LocalDateTime end);
}
